  ----------------------------------------------------------------------
GLPI - Gestionnaire Libre de Parc Informatique
 Copyright (C) 2004 by the INDEPNET Development Team.
 
 http://indepnet.net/   http://glpi.indepnet.org
 ----------------------------------------------------------------------
 Based on:
IRMA, Information Resource-Management and Administration
Christian Bauer 

 ----------------------------------------------------------------------
 LICENSE

 This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 ----------------------------------------------------------------------
 
Contenu :

- Qu'est ce que c'est ?
- Dpendances
- Mise  jour
- Installation et configuration
- Test


*************************************************************************************************************
--- Qu'est-ce que c'est ?
*************************************************************************************************************


GLPI est un gestionnaire de parc informatique.
Il permet de recenser et de grer l'intgralit des composantes matrielles
ou logicielles d'un parc informatique, et ainsi d'optimiser le travail des
techniciens grce  une maintenance plus cohrente.
Les fonctionnalits principales de l'application s'articulent autour de deux
axes :

1) L'inventaire prcis de toutes les ressources techniques, matrielles et
logicielles, existantes dont les caractristiques seront stockes dans
une base de donnes.


2) La gestion et l'historisation, des diverses oprations de maintenance et
des procdures lies, ralises sur ces ressources techniques.

Enfin, cette application a pour but d'tre dynamique et directement relie
aux utilisateurs. Une interface autorise donc ces derniers  ventuellement
prvenir le service de maintenance et  rpertorier un problme rencontr
avec l'une des ressources techniques  laquelle ils ont accs.


*************************************************************************************************************
--- Dpendances (uniquement test avec ces configurations)
*************************************************************************************************************

1) Apache 1.3.>6 with PHP 4 
2) MySQL 3.22 et suprieures


*************************************************************************************************************
--- MISES A JOUR DEPUIS LA VERSION 0.3
*************************************************************************************************************


I) Sauvegarde de votre ancienne configuration :

Avant de faire quoi que ce soit il convient de faire deux choses :

Sauvegardez votre base de donne via l'interface de sauvegarde de glpi et 
rcuprez le fichier dump contenant les donnes dans le rpertoire backups/dump/ 
et faites en une sauvegarde.

Rcuprez le fichier config.php dans le rpertoire glpi/config/ et copiez le ailleurs 
sur votre disque et faites en une sauvegarde.

A partir de l, si la mise  jour se droule mal ou que les nouvelles implantation de 
la version 0.4 ne vous conviennent pas, il sera facile de revenir  votre version prcdente.

Si nanmoins cette procdure se droulait mal, merci de nous faire parvenir au plus vite sur 
les mailing listes, ou sur le forum du site du projet, ou sur le bugtrack la procdure utilise 
et le message d'erreur que vous obtenez.

II) Rcupration et installation des fichiers.


1)Supprimez le rpertoire contenant GLPI ainsi que tout son contenu, de votre racine http.

2)Tlchargez le tarball de la version 0.4 disponible dans la rubrique tlchargement du site du 
projet glpi (http://glpi.indepnet.org).


3)Dcompressez la nouvelle archive de GLPI,  la place de l'ancienne.

4)Changez les droits sur les dossiers suivants :

-[votre_racine_http/]glpi/backups/dump
-[votre_racine_http/]glpi/glpi/config/


de manire  ce que PHP y ait les droits d'criture.


III)Lancement de la mise  jour :

1) Faites pointer votre navigateur web sur http://votreserveur/glpi/

2) Slectionnez la langue dans laquelle vous souhaitez effectuer la mise  jour et cliquez sur  ok .

3) Cliquez sur  mise  jour .

4) Vrifiez que les tests d'environnement on bien tous t ralis avec succs, sinon suivez les 
instructions et ressayez.

Si tout c'est bien pass, cliquez sur  continuer .

5)Configurez l'accs au serveur Mysql, aidez vous du fichier config.php que vous avez sauvegard, 
pour remplir :
Mysql serveur : le nom d'hte mysql
Mysql user : le nom d'utilisateur mysql
Mysql pass : le mot de passe associ au nom d'utilisateur mysql

Une fois tout ceci fait cliquez sur  continuer 

6) Slectionnez la base de donnes que vous souhaitez mettre  jour.
Si vous ne connaissez pas son nom, rfrez vous au fichier config.php que vous avez sauvegard, 
il s'agit du nom se trouvant dans la variable $dbdefault.
Cliquez sur  continuer 

7) Un cran vous demande si vous tes sr de vouloir mettre  jour votre base de donnes, 
cliquez sur  continuer  si c'est la cas.

8) La mise  jour commence, cela peut prendre un certain temps en fonction de la taille de 
votre base de donnes.

IMPORTANT : La mise  jour depuis une version infrieure vers GLPI 0.4 ne vous permet pas de prserver 
automatiquement vos configurations prcises (configurations gnrales, sources externes, mailing etc etc)
 qui taient conserves dans le fichier config.php.

Il vous faudra utiliser les formulaires de configuration post-installation dans le menu  configuration 
 de l'application.

Ces menus ne sont accessibles qu'a un nouveau type d'utilisateur ajout dans glpi : le  super-admin , 
la mise a jour effectue donc automatiquement la conversion  admin -> super-admin  ou vous permet 
de crer un utilisateur  super-admin 


A partir de ce moment, plusieurs cas sont possibles en fonction de la version depuis laquelle vous 
mettez votre base de donne  jour et de vos anciennes configurations.


CAS 1: Vous aviez des utilisateurs de type  admin , ou qu'au moins un des utilisateurs de type 
 admin  ne se connectaient pas  l'application depuis des sources externes (ldap,imap) (puisque 
dans ce cas le mot de passe n'est pas stock dans la base de donnes).

Tous vos utilisateurs ayant auparavant les droits  admin  et un mot de passe non vide se retrouvent 
avec les droits  super-admin , un message vous en informe.

Votre base de donnes est a jour, vous pouvez dsormais configurer GLPI en cliquant sur  utiliser GLPI  
et en vous connectant avec l'un des utilisateurs anciennement admin.



CAS 2: Vous n'aviez pas d'utilisateurs de type  admin  ou que tous les  admin  ont un mot de passe vide 
(puisqu'ils se connectent depuis des sources externes).

Le script vous demande de bien vouloir saisir un nom d'utilisateur et de un mot de passe associ (n'entrez 
pas le nom d'un utilisateur dj existant).

Si cette procdure russi, votre base de donnes maintenant  jour vous pouvez configurer GLPI en cliquant 
sur  utilisez GLPI  et en vous connectant avec l'utilisateur que vous venez de crer.

Une fois la configuration termine, vous pourrez supprimer cet utilisateur. Attention assurez vous qu'il 
reste toujours un utilisateur  super-admin  ayant la possibilit de se connecter  l'application, 
ne serait qu'en cas de problmes avec les sources de donnes externes.




*************************************************************************************************************
--- INSTALLATION DE GLPI ET CONFIGURATION
*************************************************************************************************************

L'installation de GLPI est assez simple. Depuis la version 0.4 il n'y a plus, en particulier, de fichier  
modifier   la main .

La procdure est la suivante :

1. Rcuprez l'archive de GLPI sur notre serveur, et la dcompacter sur votre ordinateur personnel. 
Vous obtenez un dossier glpi contenant l'ensemble des fichiers du logiciel GLPI.

2. Copier ce dossier sur le serveur destin  accueillir GLPI.

3. Connectez-vous avec votre navigateur sur GLPI. GLPI vous proposera une interface graphique vous permettant 
de configurer le logiciel. Une fois ces quelques informations de configuration fournies, 
GLPI sera totalement install et vous pourrez commencer  travailler.

------ Procdure dtaille

--- Configuration ncessaire

Vous devez au minimum disposer d'un espace sur un serveur Web avec :
-  un accs au serveur pour l'installation des fichiers (FTP, SSH, etc);
-  le support de PHP4 ou suprieure compile avec le support des sessions ;
-  un accs  une base de donnes MySQL.

Avant l'installation, vous devez avoir une base MySQL disponible. Si vous n'tes pas l'administrateur 
du serveur, il faut demander l'activation d'une base MySQL  l'administrateur.

Vous devez connatre les donnes de votre connexion MySQL (fournies par l'administrateur) :
-  l'adresse du serveur MySQL ;
-  votre login MySQL ;
-  votre password MySQL ;
-  le nom de la base de donnes

--- Rcuprer GLPI

GLPI est disponible en tlchargement par le Web  l'adresse :
-  http://glpi.indepnet.org rubrique tlchargement.

Choisissez la version qui vous intresse, dcompactez l'archive sur votre ordinateur dans un rpertoire 
de votre choix, puis transfrez le contenu de ce rpertoire sur le serveur Web.

Si vous tes l'administrateur du serveur dcompresser l'archive dans le rpertoire racine d'Apache 
(/var/www  ou /var/www/html).

--- Installer les fichiers

Installez l'ensemble des fichiers de GLPI dans l'espace Web,  l'endroit o vous voulez que GLPI soit 
accessible au public.

Maintenant, il est ncessaire d'accorder des permissions  certains rpertoires, de manire  ce que PHP 
ait les droits en criture sur : /backups/dump /glpi/config

--- Dbut de l'installation

Dsormais tout se droule en ligne. Pour dbuter l'installation il vous suffit de faire pointer votre 
navigateur web sur le dossier racine de GLPI : http://votreserveur/glpi/ (par dfaut).

Lors de la premire connexion  cette adresse, une procdure d'installation pas--pas dmarre. 
L'interface est intuitive, il suffit d'entrer les informations demandes.

--- tapes prliminaires :

A- Choix de la langue.

Vous arrivez alors sur la premire tape prliminaire, qui consiste  choisir la langue dans laquelle 
se droulera l'installation.

Si vous voulez que la langue soit le Franais slectionnez  french  et cliquez sur  OK .

B- Installation ou mise  jour.

Vous souhaitez faire une installation, donc cliquez sur  Installation .

C- Vrification de la compatibilit de votre environnement avec l'excution de GLPI

Cette tape va vrifier que vous avez correctement ralis les pr-requis  l'installation. Si ce n'est 
pas le cas, il vous sera impossible d'accder aux tapes suivantes. Un message d'erreur assez explicite 
vous indiquera les actions  raliser avant de ressayer.

Si toutes les vrifications ont t ralises avec succs, cliquez sur  continuer .

--- tapes de l'installation

tape 1 : Configuration des informations de connection au serveur de base de donnes.

Vous arrivez alors sur un formulaire vous permettant d'entrer les informations ncessaire  la connection 
au serveur MySQL.

Dans le champs  Mysql server  entrez le chemin rseau d'accs au serveur, par exemple : localhost, ou 
mysql.domaine.tld

Dans le champs  Mysql user  entrez le nom d'utilisateur vous permettant de vous connecter au serveur Mysql.

Dans le champs  Mysql pass  entrez le mot de passe associ  l'utilisateur que vous venez d'entrer dans le 
champs  Mysql user  Ce champs peut tre laiss vide si l'utilisateur n'as pas de mot de passe (Il ne sera 
pas fait de commentaires sur la scurit d'un tel usage de Mysql car ce n'est pas l'objet de cet article).

Une fois que ces trois champs sont correctement remplis cliquez sur  continuer .

L deux possibilits :

-  soit vos paramtres sont valides, auquel cas vous passez  l'tape suivante.
-  Soit vos paramtres sont invalides, auquel cas un message d'erreur est affich, cliquez sur retour pour 
modifier vos paramtres de connection et essayer de nouveau.

tape 2 : Cration ou choix de la base de donnes et initialisation.

Maintenant que vous tes correctement connect au serveur MySQL, vous devez crer ou choisir la base de donnes 
destine  accueillir l'application GLPI.

Deux possibilits :

-  Une base dj existante destine  accueillir GLPI est dj en place :

Slectionnez cette base dans la liste des bases affiches. Cliquez sur continuer pour initialiser 
la base de donnes.

-  Vous souhaitez crer une nouvelle base de donnes pour accueillir GLPI :

Attention cette tape ncessite que l'utilisateur ai les droits ncessaires  la cration dune nouvelle base.

Slectionnez  crer une nouvelle base de donnes . Entrez le nom que vous souhaitez donner  la base 
dans le champ texte prvu  cet effet. Cliquez sur continuer pour initialiser la base de donnes.

tape 3 : Transition et explications :

Cette tape vous informe que la base de donnes est initialise avec les valeurs par dfaut. 
Et vous donne un certain nombre d'indications sur ces valeurs. Lisez attentivement ces informations 
et cliquez sur  continuer .

L'tape 4 : vous indique que l'installation de GLPI est maintenant termine, et vous rcapitule un 
certain nombre d'informations. Lisez attentivement ces informations et cliquez sur  utiliser GLPI  
pour effectuer votre premire connection  l'application.

--- Fin de l'installation

En cas de grosse erreur (du genre : vous avez oubli votre propre accs  GLPI...), pour  relancer  cette 
procdure d'installation, il faut utiliser votre logiciel FTP (par exemple) et effacer le fichier suivant :
-  glpi/config/config_db.php

Pointer votre navigateur web sur le dossier racine de GLPI : http://votreserveur/glpi/ (par dfaut) relancera 
alors la procdure de configuration (en ralit, c'est l'absence de fichier  config_db.php  qui provoque le 
lancement de cette procdure).



